home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / dev / src / wangisrc.lha / wangi / z / chunker / chunker.doc < prev    next >
Text File  |  1996-04-18  |  4KB  |  134 lines
  1. />SETVAR PROGRAM Chunker<\/>SETVAR FREQNAME CHUNKER<\      ______________      ______________
  2.      /             /     /_/_/_/_/_/_/_/   Chunker />Version Chunker NN ND<\ <--> DeChunk />Version Chunker NN ND<\
  3.     /             /     /_/_/_/_/_/_/_/
  4.    /             /     /_/_/_/_/_/_/_/     A portable method of splitting
  5.   /             / <-> /_/_/_/_/_/_/_/      and joining files.
  6.  /             /     /_/_/_/_/_/_/_/
  7. /_____________/     /_/_/_/_/_/_/_/        Copyright ©/>DATE LF="%Y"<\ Lee Kindness.
  8.  
  9.  
  10. Chunker:
  11. Compiled           />Date from Chunker LF="%A %d %B %Y %q:%M:%S"<\
  12. Amiga Exe size     />Program NL List Chunker LFORMAT=%l<\ bytes
  13. Amiga 1.3 size     />Program NL List Chunker13 LFORMAT=%l<\ bytes
  14. MSDOS Exe size     />Program NL List CHUNKER.EXE LFORMAT=%l<\ bytes
  15. Version            />Version Chunker FULL<\
  16.  
  17. DeChunk:
  18. Compiled           />Date from DeChunk LF="%A %d %B %Y %q:%M:%S"<\
  19. Amiga Exe size     />Program NL List DeChunk LFORMAT=%l<\ bytes
  20. Amiga 1.3 size     />Program NL List DeChunk13 LFORMAT=%l<\ bytes
  21. MSDOS Exe size     />Program NL List DECHUNK.EXE LFORMAT=%l<\ bytes
  22. Version            />Version DeChunk FULL<\
  23.  
  24. Distribution built />Date LF="%A %d %B %Y %q:%M:%S"<\
  25.  
  26.  
  27.  LEGAL
  28. -=====-
  29.  
  30. />Insert S:Legal<\
  31.  
  32.  
  33.  COMPILATION
  34. -===========-
  35.  
  36.  This archive includes versions of Chunker and DeChunk for the Amiga (chunker
  37.  and dechunk for 2.0 and higher, chunker13 and dechunk13 for 1.2 and higher)
  38.  and MSDOS (CHUNKER.EXE and DECHUNK.EXE). The ANSI C source code is included
  39.  in the source drawer. This source should complile with all ANSI C compilers.
  40.  To compile the unix version simply type 'make' in the source directory. The 
  41.  makefile does the following:
  42.  
  43.    CC -O2 -o chunker chunker.c machine.c bfn.c
  44.    CC -O2 -o dechunk dechunk.c machine.c bfn.c
  45.       ### ##########
  46.        |      \
  47.  turns |       \ specifies the name of the compiled program
  48.  on level        to create.
  49.  2 optimisation
  50.  
  51.  By default the (Unix) makefile uses the "CC" compiler - you may wish to
  52.  change this to "gcc" for example, see the makefile for more info
  53.  
  54.  
  55.  USAGE
  56. -=====-
  57.  
  58.  Chunker is used to split a file up into smaller pieces. It expects the
  59.  following arguments:
  60.  
  61.    chunker <file> <basename> <size>
  62.  
  63.  file: Name of the file to split.
  64.  
  65.  basename: The created split files will have this as their base name. For
  66.     example if you had "ding" as basename then the created files would
  67.     be:
  68.         ding.000
  69.         ding.001
  70.         :
  71.         :
  72.         ding.XXX
  73.     Note that the XXX part is a 3 part hexadecimal number.
  74.  
  75.  size: Size (in bytes) of the created chunks.
  76.  
  77.  For example:
  78.  
  79.    chunker bigfile.gz bigfile 716800
  80.  
  81.  would split the file 'bigfile.gz' into 700k chunks with a basname of
  82.  'bigfile'.
  83.  
  84.  
  85.  DeChunk will reassemble the chunks output by Chunker into the original
  86.  file. It expects the following arguments:
  87.  
  88.    dechunk <outputfile> <basename>
  89.  
  90.  outputfile: Name of the file to create.
  91.  
  92.  basename: The basename of the split files. For example if the first of the 
  93.     split files is called "ding.000" then use "ding". This should be the
  94.     same as you passed as basename to Chunker.
  95.  
  96.  
  97.  NOTE the Amiga join or Unix cat commands could be used rather than dechunk,
  98.  if you're a masochist that is ;)
  99.  
  100.  NOTE that the amiga 2.0 version accepts arguments in the normal ReadArgs
  101.  format, just type 'chunker ?' and 'dechunk ?' for the template. The
  102.  Amiga versions are also pure and reentrant, and as such can be made
  103.  resident.
  104.  
  105.  
  106.  CONTACT
  107. -=======-
  108.  
  109. />Insert S:Contact<\
  110.  
  111. The initial concept and code for Chunker was by Evan Tuer. You can email
  112. Evan at alienz@freenet.hut.fi. Of course he also came up with the name...
  113.  
  114.  
  115.  LATEST VERSION
  116. -==============-
  117.  
  118. />Insert S:ffplug<\
  119.  
  120.  
  121.  VERSION HISTORY
  122. -===============-
  123.  
  124. />Insert History<\
  125.  
  126.  
  127.  OTHER PROGRAMS
  128. -==============-
  129.  
  130. />Insert S:Programs<\
  131.  
  132.  
  133. />Insert S:.signature<\
  134.